OpenEdge Development:<br />Progress Dynamics Advanced Development Layout table

The ryc_layout table defines the available page layouts for pages on SmartFolder™ windows, for example, one browser with one toolbar underneath, n viewers above each other, two side-by- side viewers, two side-by-side browsers, etc. It also defines the available frame layouts for objects on a frame, for example, one column, two columns, etc. The purpose of this table is to specify the program that is responsible for the layout when the window/frame is constructed or resized.

Most of the layout types defined in the layout table are in fact no longer actively used in building Progress Dynamics container windows. They are still used for windows in the framework tools themselves that have been built in earlier versions of the framework. The primary layout type now used is the Relative layout. However, the structure of the table and its fields remains the same. It has these fields:

layout_name — This CHARACTER field is a unique name to identify the layout, for example, Relative.

layout_type — This field is a three-character code to identify the type of layout, specifically the kinds of context in which it can be used. Currently, defined values for the layout type are PAG = Page Layout, FRA = Frame Object Layout, BTH = Both.

layout_narrative — This CHARACTER field is a free-form description for the layout.

layout_filename — This CHARACTER field value is the filename to run, including its relative path, in order to actually perform the layout of the objects on the page during initial construction and any later resize event. The Layout Manager procedure that uses this data is ry/prc/rylayoutsp.p, which is accessed from the dynamic SmartWindow procedure ry/uib/rydyncontw.w to do dynamic layout of container windows.

sample_image_filename — This CHARACTER field contains the name and relative path of an image file that can be displayed illustrating the page layout, if one is available.

system_owned — If this LOGICAL field is set to YES, this record can only be modified by users with a system-owned flag in their user profile.

layout_code — This CHARACTER field is a suffix to add to internal procedures in the layout manager PLIP to identify the specific layout manager, for example, ‘01’ would run the procedure version resize01 for this layout. The Relative layout uses layout code ‘06’.

When containers of any kind are created to hold object instances, page and page_object records are created to define the contents of each page of a container.